home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / join.z / join
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. jjjjooooiiiinnnn((((1111))))                                                                jjjjooooiiiinnnn((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _jjjj_oooo_iiii_nnnn - relational database operator
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _jjjj_oooo_iiii_nnnn [ -_a _n | -_v _n ] [ -_e _s ] [ -_o _l_i_s_t ] [ -_t _c ] [ -_1 _f_i_e_l_d ] [ -_2
  13.      _f_i_e_l_d ] _f_i_l_e_1 _f_i_l_e_2
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _jjjj_oooo_iiii_nnnn forms, on the standard output, a join of the two relations specified
  18.      by the lines of _f_i_l_e_1 and _f_i_l_e_2.  If _f_i_l_e_1 is _----, the standard input is
  19.      used.  _f_i_l_e_1 and _f_i_l_e_2 must be sorted in increasing code set collating
  20.      sequence on the fields on which they are to be joined, normally the first
  21.      in each line [see _ssss_oooo_rrrr_tttt(1)].  _jjjj_oooo_iiii_nnnn processes supplementary code set
  22.      characters in files, and recognizes supplementary code set characters
  23.      given to the _----_eeee and _----_tttt options (see below) according to the locale
  24.      specified in the _LLLL_CCCC______CCCC_TTTT_YYYY_PPPP_EEEE environment variable [see _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)].
  25.  
  26.      There is one line in the output for each pair of lines in _f_i_l_e_1 and _f_i_l_e_2
  27.      that have identical join fields.  The output line normally consists of
  28.      the common field, then the rest of the line from _f_i_l_e_1, then the rest of
  29.      the line from _f_i_l_e_2.
  30.  
  31.      The default input field separators are blank, tab, or new-line.  In this
  32.      case, multiple separators count as one field separator, and leading
  33.      separators are ignored.  The default output field separator is a blank.
  34.  
  35.      Some of the options below use the argument _n.  This argument should be a
  36.      _1111 or a _2222 referring to either _f_i_l_e_1 or _f_i_l_e_2, respectively.  The following
  37.      options are recognized:
  38.  
  39.      _----_aaaa _n     In addition to the normal output, produce a line for each
  40.               unpairable line in file _n, where _n is 1 or 2.
  41.  
  42.      _----_eeee _s     Replace empty output fields with string _s.  _s may contain
  43.               supplementary code set characters.
  44.  
  45.      _----_oooo _l_i_s_t  Each output line includes the fields specified in _l_i_s_t, each
  46.               element of which has the form _n_...._m, where _n is a file number and
  47.               _m is a field number.  The common field is not printed unless
  48.               specifically requested. The list must be a single command line
  49.               argument.
  50.  
  51.      _----_tttt _c     Use character _c as a separator (tab character).  Every
  52.               appearance of _c in a line is significant.  The character _c is
  53.               used as the field separator for both input and output.  _c may be
  54.               a supplementary code set character.
  55.  
  56.      _----_vvvv _n     Instead of the default output, produce a line only for each
  57.               unpairable line in n, where n is 1 or 2. If both _----_vvvv _1 and _----_vvvv _2
  58.               are specified, all unpairable lines will be output.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. jjjjooooiiiinnnn((((1111))))                                                                jjjjooooiiiinnnn((((1111))))
  71.  
  72.  
  73.  
  74.      _----_1111 _f_i_e_l_d Join the fieldth field of file 1. Fields are decimal integers
  75.               starting with 1.
  76.  
  77.      _----_2222 _f_i_e_l_d Join the fieldth field of file 2. Fields are decimal integers
  78.               starting with 1.
  79.  
  80.      The following options are obsoleted:
  81.  
  82.      _----_jjjj _f_i_e_l_d
  83.           Equivalent to:  _----_1111 _ffff_iiii_eeee_llll_dddd _----_2222 _ffff_iiii_eeee_llll_dddd.
  84.  
  85.      _----_jjjj_1 _f_i_e_l_d
  86.           Equivalent to:  _----_1111 _ffff_iiii_eeee_llll_dddd.
  87.  
  88.      _----_jjjj_2 _f_i_e_l_d
  89.           Equivalent to:  _----_2222 _ffff_iiii_eeee_llll_dddd.
  90.  
  91. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  92.      The following command line will join the password file and the group
  93.      file, matching on the numeric group ID, and outputting the login name,
  94.      the group name, and the login directory.  It is assumed that the files
  95.      have been sorted in code set collating sequence on the group ID fields.
  96.  
  97.        _jjjj_oooo_iiii_nnnn _----_1111 _4444 _----_2222 _3333 _----_oooo _1111_...._1111_,,,,_2222_...._1111_,,,,_1111_...._6666 _----_tttt _:::: _////_eeee_tttt_cccc_////_pppp_aaaa_ssss_ssss_wwww_dddd _////_eeee_tttt_cccc_////_gggg_rrrr_oooo_uuuu_pppp
  98.  
  99. FFFFIIIILLLLEEEESSSS
  100.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_dddd_ffff_mmmm
  101.           language-specific message file [See _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5).]
  102.  
  103. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  104.      _aaaa_wwww_kkkk(1), _cccc_oooo_mmmm_mmmm(1), _ssss_oooo_rrrr_tttt(1), _uuuu_nnnn_iiii_qqqq(1)
  105.  
  106. NNNNOOOOTTTTEEEESSSS
  107.      With default field separation, the collating sequence is that of _ssss_oooo_rrrr_tttt _----_bbbb;
  108.      with _----_tttt, the sequence is that of a plain sort.
  109.  
  110.      The conventions of the _jjjj_oooo_iiii_nnnn, _ssss_oooo_rrrr_tttt, _cccc_oooo_mmmm_mmmm, _uuuu_nnnn_iiii_qqqq, and _aaaa_wwww_kkkk commands are
  111.      wildly incongruous.
  112.  
  113.      As an obsolescent feature, mutiple arguments can be specified for _----_oooo
  114.      option.  At that time, filenames that are numeric may cause conflict when
  115.      the _----_oooo option is used just before listing filenames.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.